home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3x / curs_addchst.z / curs_addchst
Encoding:
Text File  |  1998-10-20  |  6.4 KB  |  63 lines
  1.  
  2.  
  3.  
  4. ccccuuuurrrrssss____aaaaddddddddcccchhhhssssttttrrrr((((3333XXXX))))                                            ccccuuuurrrrssss____aaaaddddddddcccchhhhssssttttrrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_uuuu_rrrr_ssss______aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr:  _aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr, _aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr, _wwww_aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr, _wwww_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr, _mmmm_vvvv_aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr,
  10.      _mmmm_vvvv_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr, _mmmm_vvvv_wwww_aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr, _mmmm_vvvv_wwww_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr - add string of characters (and
  11.      attributes) to a _cccc_uuuu_rrrr_ssss_eeee_ssss window
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>>
  15.  
  16.      _iiii_nnnn_tttt _aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr_((((_cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_))))_;;;;
  17.      _iiii_nnnn_tttt _aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr_((((_cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  18.      _iiii_nnnn_tttt _wwww_aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_))))_;;;;
  19.      _iiii_nnnn_tttt _wwww_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  20.      _iiii_nnnn_tttt _mmmm_vvvv_aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_))))_;;;;
  21.      _iiii_nnnn_tttt _mmmm_vvvv_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  22.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_aaaa_dddd_dddd_cccc_hhhh_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_))))_;;;;
  23.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_tttt_yyyy_pppp_eeee _****_cccc_hhhh_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      All of these routines copy _c_h_s_t_r directly into the window image structure
  27.      starting at the current cursor position.  The four routines with _n as the
  28.      last argument copy at most _n elements, but no more than will fit on the
  29.      line.  If _nnnn=_----_1111 then the whole string is copied, to the maximum number
  30.      that fit on the line.
  31.  
  32.      The position of the window cursor is not advanced.  These routines work
  33.      faster than _wwww_aaaa_dddd_dddd_nnnn_ssss_tttt_rrrr because they merely copy _c_h_s_t_r into the window image
  34.      structure.  On the other hand, care must be taken when using these
  35.      functions because they don't perform any kind of checking (such as for
  36.      the newline character), they don't advance the current cursor position,
  37.      and they truncate the string, rather then wrapping it around to the new
  38.      line.
  39.  
  40. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  41.      All routines return the integer _EEEE_RRRR_RRRR upon failure and an integer value
  42.      other than _EEEE_RRRR_RRRR upon successful completion, unless otherwise noted in the
  43.      preceding routine descriptions.
  44.  
  45. NNNNOOOOTTTTEEEESSSS
  46.      The header file _cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh automatically includes the header files _ssss_tttt_dddd_iiii_oooo_...._hhhh
  47.      and _uuuu_nnnn_cccc_tttt_rrrr_llll_...._hhhh.
  48.  
  49.      Note that all routines except _wwww_aaaa_dddd_dddd_cccc_hhhh_nnnn_ssss_tttt_rrrr may be macros.
  50.  
  51. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.      _cccc_uuuu_rrrr_ssss_eeee_ssss(3X)
  53.  
  54.  
  55.  
  57.  
  58.  
  59.                                                                         PPPPaaaaggggeeee 1111
  60.  
  61.  
  62.  
  63.